<!DOCTYPE html>
<html>
  <head>
    <meta name="creator" content="mantohtml v2.0.1">
    <title>lpstat(1)</title>
  </head>
  <body>
    <h1 id="lpstat-1">lpstat(1)</h1>
    <h2 id="lpstat-1.name">Name</h2>
<p>lpstat - print cups status information
</p>
    <h2 id="lpstat-1.synopsis">Synopsis</h2>
<p><strong>lpstat</strong>
[
<strong>-h </strong><em>hostname</em>[<strong>:</strong><em>port</em>]
] [
<strong>-E</strong>
] [
<strong>-H</strong>
] [
<strong>-U</strong>
<em>username</em>
] [
<strong>-l</strong>
] [
<strong>-W</strong>
<em>which-jobs</em>
] [
<strong>-a</strong>
[
<em>destination(s)</em>
] ] [
<strong>-c</strong>
[
<em>class(es)</em>
] ] [
<strong>-d</strong>
] [
<strong>-e</strong>
] [
<strong>-o</strong>
[
<em>destination(s)</em>
] ] [
<strong>-p</strong>
[
<em>printer(s)</em>
] ] [
<strong>-r</strong>
] [
<strong>-R</strong>
] [
<strong>-s</strong>
] [
<strong>-t</strong>
] [
<strong>-u</strong>
[
<em>user(s)</em>
] ] [
<strong>-v</strong>
[
<em>printer(s)</em>
] ]
</p>
    <h2 id="lpstat-1.description">Description</h2>
<p><strong>lpstat</strong> displays status information about the current classes, jobs, and printers.
When run with no arguments, <strong>lpstat</strong> will list active jobs queued by the current user.
</p>
    <h2 id="lpstat-1.options">Options</h2>
<p>The <strong>lpstat</strong> command supports the following options:
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-E</strong><br>
Forces encryption when connecting to the server.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-H</strong><br>
Shows the server hostname and port.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-R</strong><br>
Shows the ranking of print jobs.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-U </strong><em>username</em><br>
Specifies an alternate username.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-W </strong><em>which-jobs</em><br>
Specifies which jobs to show, &quot;all, &quot;successful&quot;, &quot;completed&quot; or &quot;not-completed&quot; (the default).
This option <em>must</em> appear before the <em>-o</em> option and/or any printer names, otherwise the default (&quot;not-completed&quot;) value will be used in the request to the scheduler.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-a </strong>[<em>printer(s)</em>]<br>
Shows the accepting state of printer queues.
If no printers are specified then all printers are listed.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-c </strong>[<em>class(es)</em>]<br>
Shows the printer classes and the printers that belong to them.
If no classes are specified then all classes are listed.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-d</strong><br>
Shows the current default destination, either the
<strong>lpoptions</strong>(1)

default (if set) or the scheduler default (otherwise).
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-e</strong><br>
Shows all available destinations on the local network.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-h </strong><em>server</em>[<strong>:</strong><em>port</em>]<br>
Specifies an alternate server.
Note: This option must occur before all others.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-l</strong><br>
Shows a long listing of printers, classes, or jobs.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-o </strong>[<em>destination(s)</em>]<br>
Shows the jobs queued on the specified destinations.
If no destinations are specified all jobs are shown.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-p </strong>[<em>printer(s)</em>]<br>
Shows the printers and whether they are enabled for printing.
If no printers are specified then all printers are listed.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-r</strong><br>
Shows whether the CUPS server is running.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-s</strong><br>
Shows a status summary, including the default destination, a list of classes and their member printers, and a list of printers and their associated devices.
This is equivalent to using the <em>-d</em>, <em>-c</em>, and <em>-v</em> options.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-t</strong><br>
Shows all status information.
This is equivalent to using the <em>-r</em>, <em>-d</em>, <em>-c</em>, <em>-v</em>, <em>-a</em>, <em>-p</em>, and <em>-o</em> options.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-u </strong>[<em>user(s)</em>]<br>
Shows a list of print jobs queued by the specified users.
If no users are specified, lists the jobs queued by the current user.
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>-v </strong>[<em>printer(s)</em>]<br>
Shows the printers and what device they are attached to.
If no printers are specified then all printers are listed.
</p>
    <h2 id="lpstat-1.environment">Environment</h2>
<p>The following environment variables override the default destination:
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>LPDEST</strong><br>
Specifies the default print queue (System V standard).
</p>
    <p style="margin-left: 2.5em; text-indent: -2.5em;"><strong>PRINTER</strong><br>
Specifies the default print queue (Berkeley standard).
</p>
    <h2 id="lpstat-1.conforming-to">Conforming To</h2>
<p>Unlike the System V printing system, CUPS allows printer names to contain any printable character except SPACE, TAB, &quot;/&quot;, and &quot;#&quot;.
Also, printer and class names are <em>not</em> case-sensitive.
</p>
    <p>The <em>-h</em>, <em>-e</em>, <em>-E</em>, <em>-U</em>, and <em>-W</em> options are unique to CUPS.
</p>
    <p>The Solaris <em>-f</em>, <em>-P</em>, and <em>-S</em> options are silently ignored.
</p>
    <h2 id="lpstat-1.see-also">See Also</h2>
<p><strong>cancel</strong>(1),

<strong>lp</strong>(1),

<strong>lpq</strong>(1),

<strong>lpr</strong>(1),

<strong>lprm</strong>(1),

CUPS Online Help (<a href="http://localhost:631/help">http://localhost:631/help</a>)
</p>
    <h2 id="lpstat-1.copyright">Copyright</h2>
<p>Copyright &copy; 2020-2024 by OpenPrinting.
  </body>
</html>
